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ABSTRACT 


The  computerized  Quick-Reacting  General  War  Gaming  System  (QUICK)  will 
accept  input  data,  automatically  generate  global  strategic  nuclear  war 
plans,  provide  output  summaries,  and  produce  input  tapes  to  simulator 
subsystems  external  to  QUICK.  QUICK  has  been  programmed  in  FORTRAN  for 
use  on  the  CCTC  HIS  6000  computer  system. 


The  QUICK  Usfers  Manual  consists  of  four  volumes:  Volume  I,  Data  Manage¬ 
ment  Subsystem;  Volume  II,  Weapon/Target  Identification  Subsystem;  Vol¬ 
ume  III,  Weapon  Allocation  Subsystem;  Volume  IV,  Sortie  Generation  Sub¬ 
system.  The  Users  Manual  complements  the  other  QUICK  Computer  System 
Manuals  to  facilitate  application  of  the  war  gaming  system.  This  vol¬ 
ume,  Volume  III,  provides  detailed  Instructions  for  execution  of  the 
Weapon  Allocation  Subsystem  and  the  modules  it  comprises.  Companion 
documents  are :  /\ 

\ 

a.  PROGRAM  MAINTENANCE  MANUAL 

Computer  System  Manual  CSM  MM  9-77,  Volume  I 

Computer  System  Manual  CSM  MM  9-77,  Volume  II 

Computer  System  Manual  CSM  MM  9-77,  Volume  III 

Computer  System  Manual  CSM  MM  9-77,  Volume  IV 

Provides  detailed  instructions  for  maintenance  of  the  system. 


b.  TECHNICAL  MEMORANDUM 

Technical  Memorandum  TM  15-3-77 

Provides  a  nontechnical  description  of  the  system  for  senior 
management  personnel. 
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SECTION  1.  GENERAL 


1.1  Purpose 

This  volume  of  the  QUICK  Users  Manual  informs  the  CCTC  user/analyst  in 
the  preparation  of  control  cards,  structure  of  execution  (run)  decks, 
preparation  of  computer  job  requests,  and  in  the  analyzation  of  the 
associated  computer  output,  to  include  the  recognition  of  error  mes¬ 
sages  for  the  Weapon  Allocation  subsystem  of  QUICK.  It  complements  in¬ 
formation  contained  in  the  Program  Maintenance  Manuals  of  the  QUICK  Sys¬ 
tem.  The  abstract  of  this  document  references  other  documents  describ¬ 
ing  QUICK. 

1.2  General  Description 

The  Weapon  Allocation  subsystem  uses  the  integrated  data  base  as  defined 
by  all  preceding  modules  and  produces  a  plan  using  the  weapon  resources 
specified  to  maximize  the  expected  target  value  destroyed.  The  subsys¬ 
tem  consists  of  modules  PREPALOC ,  ALOC,  EVALALOC,  and  ALOCOUT ,  as  shown 
in  figure  1.  Figure  2  shows  the  relationship  of  the  Weapon  Allocation 
subsystem  to  other  QUICK  subsystems  in  terms  of  procedural  and  informa¬ 
tion  flow. 

The  modules  and  supporting  subroutines  of  this  subsystem  are  used  to 
define  Information  for  use  in  later  processes  and  allocate  given  weap¬ 
ons  to  targets  to  optimize  expected  value  destroyed.  Modules  for  this 
subsystem  must  be  executed  sequentially  in  the  order  presented  within 
figure  1  (EVALALOC  is  an  optional  execution) . 

The  first  module,  PREPALOC,  precomputes  much  of  the  information  re¬ 
quired  by  later  processors.  It  organizes  the  input  data  for  efficient 
use  by  other  components  of  the  Weapon  Allocation  Subsystem.  In  addi¬ 
tion,  it  provides  capabilities  for  planning  factor  modification  and 
fixed  weapon  assignment  specification. 

The  basic  data  manipulated  by  this  module  include  the  distance  and 
attrition  factors  for  the  weapons,  the  geographic  description  of  the 
bomber  penetration  and  depenetration  corridors,  the  weapon  character¬ 
istic  tables  (e.g.,  warhead  and  payload  tables),  and  the  target  char¬ 
acteristics  . 

The  next  module,  ALOC,  performs  the  allocation  of  weapons  to  targets. 
Using  a  generalized  Lagrange  multiplier  method,  an  optimal  allocation 
is  generated  subject  to  several  forms  of  user-input  allocation  con¬ 
straints.  These  constraints  Include  specification  of  minimum  and  maxi¬ 
mum  desired  damage  levels,  restriction  of  weapons  to  specified  subsets 
of  the  target  system,  and  specification  of  weapons  allocated  to  speci¬ 
fic  targets  by  the  user.  Within  these  constraints,  the  module  gener¬ 
ates  the  allocation  which  maximizes  the  expected  value  destroyed  in 
the  target  system.  Module  ALOC  is  also  referred  to  as  the  Allocator. 
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SECTION  2.  MODULE  PREPALOC 


2.1  General  Purpose 

Module  PREPALOC  (executed  after  PLANSET)  has  four  major  capabilities: 
updating  of  weapon  group  and  target  attributes,  modification  of  target 
values,  damage  constraints  and  height-of-burst  specification,  prepara¬ 
tion  of  data  for  the  fixed  weapon  assignment  capability  of  module 
ALOC,  and  the  geographical  related  parameters. 

Weapon  groups  formulation  resides  within  module  PLANSET.  PREPALOC  per¬ 
mits  the  user  to  add  weapon  strikes  (called  overallocation)  to  weapon 
groups  whereby  providing  the  allocation  greater  flexibility  in  making 
assignments  which  ignore  serial  constraints.  The  allocator  attempts 
to  assign  the  true  inventory  plus  the  added  weapons.  The  Sortie  Genera¬ 
tion  subsystem  selects  only  the  inventory  number  of  strikes. 

The  second  major  capability  of  this  module  is  the  modification  of  the 
target  characteristics,  VTO,  MINKILL ,  and  MAXKILL.  VTO  is  the  value 
of  the  target  relative  to  the  others.  MINKILL  is  the  minimum  fraction 
of  value  that  must  be  destroyed,  and  MAXKILL  is  the  maximum  desired 
fraction  destroyed.  Any  of  these  parameters  may  be  changed  for  any 
target.  The  change  requests  can  change  these  parameters  for  a  single 
target  or  for  a  set  of  targets.  The  set  of  targets  for  which  a  change 
is  requested  is  identified  by  target  class,  type,  and  individual  iden¬ 
tifier  (target  designator  code  (DESIG)),  or  any  combination  of  these. 

For  complex  targets,  the  class,  type,  and  designator  code  of  each  com¬ 
ponent  will  be  checked  to  determine  if  a  target  parameter  for  the  com¬ 
plex  is  to  be  changed. 

An  additional  planning  factor  which  can  be  modified  in  this  program  is 
weapon  height  of  burst.  In  the  absence  of  any  user  specifications, 

QUICK  uses  the  height  of  burst  for  each  weapon/target  combination  that 
produces  the  most  damage.  However,  the  user  can  specify  use  of  air  or 
ground  bursts  in  preference  to  the  optimal  height.  The  user  can  re¬ 
quest  ground  or  air  bursts  on  the  basis  of  weapon  type,  target  designa¬ 
tor  code,  target  type,  target  class,  target  country  location,  or  target 
region. 

The  third  major  capability  is  the  request  for  allocation  of  specific 
weapons  to  specific  targets.  (These  requests  are  called  "fixed  assign¬ 
ments.")  This  fixing  of  weapons  to  targets  enables  the  user  to  deter¬ 
mine  part  of  the  weapon  allocation  while  leaving  the  allocation  module 
free  to  determine  the  remaining  allocation.  In  addition,  the  time  of 
arrival  at  target  or  salvo  launch  number  can  be  fixed  for  missile  wea¬ 
pons.  This  information  will  be  passed  to  module  PLANOUT  which  will  ad¬ 
just  the  launch  time  accordingly.  The  specified  fixed  assignment  of 
weapons  remains  in  effect  for  the  remainder  of  the  plan  generation  proc¬ 
ess.  Later  modules  will  retain  the  assignments  as  best  possible. 
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(For  example.  It  Is  possible  to  fix  a  set  of  weapons  from  a  weapon  group 
with  multiple  independently  targetable  reentry  vehicles  (MIRV)  in  such 
a  manner  that  there  are  no  feasible  footprints  that  cover  that  target 
set  adequately.  In  that  case,  some  of  the  fixed  assignment  requests 
must  be  ignored.) 

The  fourth  major  capability  is  the  calculations  and  IDS  storage  of  all 
distances  and  attrition  between  corridor  doglegs  for  use  by  other  proces¬ 
sors.  Also  the  distance  between  depenetration  corridor  and  recovery 
bases  is  calculated  and  stored. 


2.2  Input 

2.2.1  General .  Text  English  commands  to  this  module  permit  the  setting 
of  new  target  values,  MINK1LL  or  MAXKILL  as  well  as  specifying  weapon 
height  of  burst.  Also  certain  gaming  parameters  are  set  which  define 
the  game  to  be  executed.  One  final  consideration  is  permitting  the  user 
to  directly  assign  weapons  to  individual  targets. 


This  module  recognizes  the  verb  PREPARE  and  adverbs  SETTING,  FIX,  RECALC, 
and  ONPRINTS  (request  for  optional  prints) .  The  general  form  of  the  com¬ 
mand  is: 


PREPARE 


QVpnmodY] 

RECALC  J  | 

^SETTING  ^game-parameter  j  EQIJAL  (  value  J 
(attribute-1 ,  attribute-2)  j  (value ,  value)  ^AND 


(value ,  value) 


•  '  ']]] 


HHP}  (DESIG  ^  DESI^I  x  GROUP  [1  {^} 


(desig  desigj  j_  value  value j  ^ 

£anD  (desig  desigj  A  value  value  j  .  . 
^ONPRINTS  number  number,  first-last  number  .  .  . j 


2.2.2  The  RECALC  and  WPNMOD  Adverbs.  The  presence  of  the  RECALC  adverb 
causes  the  t’REPALOC  module  to  carryout  the  following  functions: 

o  Calculations  and  storage  of  geographic  data 
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•  Calculation  of  weapon  overallocation  data  and  salvo  Information 

•  Presetting  of  gaming  parameters  to  defaults. 

The  WPNMOD  adverb  causes  PREPALOC  to  accomplish  only  the  second  of  the 
above  three  functions.  This  adverb  can  be  used  when  weapon  data  has 
been  modified  but  the  geographic  data  has  not. 

Absence  of  the  RECALC  and  WPNMOD  adverbs  will  cause  PREPALOC  to  bypass 
these  functions.  The  user  may  wish  to  bypass  these  functions  in  order 
to  save  processing  time  if  the  PREPALOC  module  has  already  been  employed. 
Fixed  assignments  normally  have  been  entered  after  an  execution  of 
PREPALOC  in  the  RECALC  mode.  Non-RECALC  execution  modes  (with  no  inter¬ 
vening  tape  RESTORES)  simply  adds  data  to  the  existing  data  base. 

2.2.3  The  SETTING  Adverb.  Two  main  sets  of  data  are  considered  under 
this  clause.  The  first  permits  the  definition  of  variables  that  will 
finalize  the  game  scenario  being  executed.  The  second  allows  the  user 
to  set  attributes  in  various  combinations  of  subsets  whereby  target 
value,  MINKILL,  MAXKILL  or  height-of-burst  overrides  previous  inputs  or 
calculations. 

2. 2. 3.1  Gaming  Parameters.  The  user  has  the  capability  to  input  values 
for  parameters  given  in  table  1.  If  inputs  are  absent,  default  values 
are  used.  Simply,  values  are  entered  as: 

INITSTRK=1 

For  any  given  weapon  group,  weapons  will  be  added  for  sortie  generation 
constraint  considerations.  The  number  of  weapons  in  each  group  will  be 

WEAPONS* (1.0  +  PEX  +  (EXN/VEHICLES) ) 

where  WEAPONS  and  VEHICLES  are  PLANSET  determined;  PEX=PEXBOMB ,  PEXMISS, 
or  PEXMIRV ;  and  EXN-EXNBOMB,  EXNMISS,  or  EXNMIRV. 

2. 2. 3. 2  Target  Modifications.  The  target  modification  portion  of  the 
setting  clause  allows  the  user  to  change  target  value,  minimum  or  maxi¬ 
mum  required  destruction  fraction,  and  height  of  burst  on  any  target  or 
set  of  targets.  In  the  general  command  sentence  given  above,  generic 
word  attribute-1  refers  to  the  identification  of  the  target  set  over 
which  a  specific  change  is  to  be  effective.  Generic  word  attribute-2 
refers  to  the  attribute  that  is  to  be  changed.  Therefore: 

attribute-1  •  DESIG  (designator  code),  TYPE  (type  name),  CLASS  (target 
class  name),  CNTRYL  (target  country  location),  or  IREG 
(target  region) 
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and 


attribute- 2  -  VALUE  (target  value) ,  MINK1LL  (minimum  value  destroyed) , 
MAXKILL  (maximum  value  destroyed) ,  or  IDHOB  (target 
height  of  burst  specification),  'AIR'  or  'GROUND') 
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Table  1.  Game  Related  Parameters 


MNEMONIC  DEFAULT  RANGE 
INITSTRK  1  1  or  2 


CORMSL  0.0  0. 0-1.0 


CORBOMB 

0.0 

*0.0 

PEXBOMB* 

0.0 

*0.0 

EXNBOMB* 

3.0 

0.0-1000.0 

PEXMISS** 

0.0 

*0.0 

EXNMISS** 

0.0 

0.0-1000.0 

PEXMIRV** 

0.1 

*0.0 

EXNMIRV** 

2.0 

o.r-iooo.o 

DESCRIPTION 


Strike  type  (first  or  second).  In 
the  first  strike  case,  the  launch 
timing  is  determined  by  the  other 
two  input  parameters.  In  the  second 
strike  case,  all  alert  weapons  launch 
after  their  specified  alert  delay 
(ALRTDL),  all  nonalert  weapons  launch 
after  their  nonalert  delay  (NLRTDL) , 
and  the  detailed  coordinated  missile 
timing  parameters  in  program  PLAN0UT 
are  ignored. 

Gross  missile  launch  timing.  Defined 
as  the  fraction  of  missile  flight 
completed  at  time  zero.  A  value  of 
0.0  specifies  missile  launch;  a  value 
of  1.0  specifies  missile  impact. 

Bomber  launch  timing.  The  number  of 
nautical  miles  prior  to  the  corridor 
entry  that  each  bomber  reaches  at 
time  zero. 

The  fraction  of  bomber  weapons  added 
for  each  weapon  group  for  over  allo¬ 
cation. 

Vehicle  'loads'  added  to  each  bomber 
group.  A  vehicle  'load'  is  the  ratio 
of  the  number  of  weapons  (PLANSET 
determined)  to  the  number  of  vehicles 

Same  as  FEXBOMB  for  non-MIRV  missiles 

Same  as  EXNB0MB  for  non-MIRV  missiles 

Same  as  PEXBOMB  for  MIRV  missiles 

Same  as  EXNB0MB  for  MIRV  missiles 


These  parameters  are  modified  for  bomber  groups  with  less  than  15 
bombers. 

**These  variables  must  be  such  that  the  total  number  of  vehibles  per 
group  (including  overallocation)  does  not  exceed  1030  for  bombers  and 
1130  for  missiles. 


8 


CH-1 


Any  combination  of  target  subsetting  is  permlssable  but  there  is  a  rank¬ 
ing  order  in  the  final  storage  of  input  values.  The  order  of  priority 
is:  DESIG,  TYPE,  CLASS,  CNTRYL,  IREG.  That  is,  if  a  given  target  is 
referenced  by  more  than  one  output  target  set,  the  cited  order  applies. 

Consider: 

(TYPE, VALUE)  -  B52,10)  (CNTRYL, VALUE)  -  (US, 20)  (CLASS, VALUE)  - 
(MISSIL.10)  (DESIG, VALUE)  -  (AB123.30) 

In  terms  of  the  hierarchy,  all  targets  located  within  the  US  will  have  a 
value  of  20;  all  B52s  and  MISSILs  will  have  a  value  of  10  (even  if  lo¬ 
cated  within  the  US);  and  the  individual  target  AB123  will  have  a  value 
equal  to  30. 

If  some  targets  within  the  given  subset  are  components  of  a  target  com¬ 
plex,  the  planning  factors  for  the  complex  would  be  changed  to  agree 
with  the  modified  values  for  the  components.  If  an  attempt  is  made  to 
modify  the  same  planning  factor  for  a  complex  target  as  a  whole,  and 
also  on  a  component  of  that  complex,  the  former  change  will  be  effected 
and  the  latter  change  will  be  ignored. 

In  the  absence  of  a height-of-burst  specification,  the  optimal  height  is 
used.  When  changing  VALUE,  the  normalized  VALUE  should  be  entered. 

In  summary,  then,  this  phrase  of  the  SETTING  clause  is: 


{  DESIG  \ 
1  TYPE  I 

PREPARE  SETTING  £  {  CLASS  \ 
I  CNTRYL  j 
V  IREG  ) 


A  setting  of  IDHOB  may  also  be  used  to  preset  height  of  burst  for  a  weap¬ 
on  type  (the  attribute  altered  is  WHOB) . 

2.2.4  The  FIX  Adverb.  The  optional  fixed  assignment  clause  specifies 
the  allocation  of  weapons  to  specific  targets.  A  fixed  assignment  of 
weapons  from  a  specific  group  to  a  specific  target  is  maintained  by 
module  ALOC,  which  optimizes  the  assignment  of  the  nonfixed  weapons. 

In  addition,  the  delivery  time  (minutes  relative  to  H-hour)  of  non- 
MIRV  missile  weapons  may  be  specified.  Also  the  salvo  launch  number 
may  be  user  controlled.  Any  one  cotrmand  may  not  contain  both  the  salvo 
number  and  arrival  time,  however.  These  direct  comnands  are: 


FIX  (DESIG, GROUP)  -  (AB123,4) 

(DESIG, GROUP, ARRIVE)  -  (AD187 ,6 , . 5)  AND  (FA001,92,1) 
(DESIG, GROUP, SALVO)  -  (FE001,7,1) 


The  first  command  fixes  a  weapon  from  group  4  to  target  AB123,  and  down¬ 
time  is  dependent  on  the  time  of  flight.  The  second  command  fixes  weapons 
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from  groups  6  and  92  to  targets  AD187  and  FA001  with  downtimes  of 
.5  and  1,  respectively.  The  third  command  fixes  a  weapon  from  group  7 
to  target  FE001  and  the  weapon  will  be  launched  within  the  first  salvo. 

In  many  cases  fixed  assignments  are  made  to  sets  of  targets  that  have 
sequential  DESIGs.  In  order  to  capture  this  often  used  option,  it  is 
permissible  for  the  user  to  input  a  string  of  DESIGs  for  many  targets 
thereby  fixing  one  weapon  group  from  the  indicated  weapon  group  on  each 
target.  This  command  is  an  expansion  on  the  individual  assignment  com¬ 
mand  and  is  recognized  by  the  appearance  of  the  word  DESIG  entered  twice 
and  separated  by  a  comma.  For  example: 

FIX  (DESIG, DESIG, GROUP, ARRIVE)  *  (AB127,AB227,5,1.0) 

AND  (AB228 , AB230 ,6,1.0) 

Group  5  will  have  weapons  fixed  assigned  to  all  targets  starting  with 
DESIG  AB127  and  ending  with  DESIG  AB227  (101  separate  targets).  The 
alpha-portions  of  these  two  DESIGs  must  be  equal. 

An  additional  capability  is  provided  by  the  attribute  NUMALOC.  The  user 
specifies  that  more  than  one  weapon  of  the  group  named  be  assigned  to  the 
target  (or  targets)  specified.  For  example: 

FIX  (DESIG,  GROUP,  NUMALOC)  *  (AB321,  7,  5) 

Five  weapons  from  group  7  are  to  be  assigned  to  target  AB321. 

The  following  constraints  apply: 

e  No  weapons  from  a  bomber  group  may  be  fixed  on  a  target  which 
has  been  allocated  more  than  30  weapons. 

•  No  more  than  30  weapons  may  be  fixed  on  an  undefended  target 
(MISDEF-0) . 

•  The  number  of  weapons  in  any  group  is  the  maximum  number  of 
fixed  assignments  which  may  be  made  from  that  group. 

2.2.5  The  FIXOFF  Adverb.  The  FIXOFF  adverb  is  exactly  the  same  as  the 
FIX  adverb  in  format.  However,  its  use  will  cause  the  fixed  weapon's 
DGZ  to  be  offset  from  the  specified  DESIG  by  an  amount  determined  by 
ALOCOUT. 

2.2.6  The  ONPRINTS  Adverb.  It  is  not  necessary  to  generate  all  per¬ 
missible  prints  for  every  PREPALOC  execution.  For  this  reason,  the 
ONPRINTS  adverb  permits  the  selection  of  up  to  four  separate  print 
requests  numbered  1,  2,  3,  or  4.  Print  request  number  1  supplies  geo¬ 
graphical  related  reports;  request  number  2  supplies  weapon  group  related 
prints;  request  number  3  prints  target  data;  request  number  4  generates 
target  data  as  modified  by  user  inputs. 
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The  proper  print  requests  follows  the  ONPRINTS  adverb.  A  series  of  num¬ 
bers  (In  any  order)  separated  by  at  least  a  single  space  turns  on  the 
print  requests. 


Options  3  and  4  produces  prints  concerning  the  available  target  list. 

If  desired,  the  user  may  request  a  subset  of  targets  to  be  printed  by 
Specifying  the  first  and  last  target.  This  is  possible  through  the  use 
of  special  operators  comma  (,)  and  dash  (-).  After  the  number  3  or  4 
the  starting  target  number  to  be  printed  will  follow  the  comma  operator 
and  the  last  target  number  to  be  printed  will  follow  the  dash  operator. 
Consider  the  command: 

ONPRINTS  2  3,10-1297  4,1000 

Prints  for  option  two  will  be  generated;  target  data  for  target  numbers 
between  10  and  1297  will  be  generated  for  option  three;  and  target  data 
for  target  numbers  between  1000  and  the  maximum  value  will  be  generated 
for  option  four.  If  the  comma  operator  is  missing  print  begins  with 
target  number  one. 

2. 3  Output 

2.3.1  Standard  Reports.  Standard  prints  appear  depending  upon  user  em¬ 
ployment  of  specific  options.  Gaming  parameters  (figure  3)  appear  if 
RECALC  Is  specified  and/or  any  parameter  is  changed  via  a  SETTING  clause. 
The  target  data  summary  (figure  4)  also  appears  in  the  case  of  RECALC  or 
changes.  The  fixed  assignment  summary  (figure  5)  appears  if  the  input 
contains  a  FIX  clause. 

2.3.2  Optional  Reports.  Reports  generated  for  print  option  one  are 
given  in  figures  6  through  8;  figure  13  for  option  two;  figure  14  for 
option  three;  and  figure  16  for  option  four. 

2.3.3  Error  Messages.  All  possible  error  messages  produced  for  PREPALOC 
are  explained  in  figure  17. 
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Information  Print  (Part  1  of  2) 
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Figure  16.  Print  Option  4:  Planning  Factor  Changes 


o  ON PRINTS  User  selects  desired  print  option  and  specifies 

ranges  and  frequencies  for  those  prints 

o  PUNCH  User  requests  output  of  final  Lagrange  multipliers 

o  READMUL  User  specifies  values  for  Lagrange  multipliers  to 

be  used  at  the  outset  of  ALOC  execition 

o  RECALC  User  specifies  that  the  Weapon  Data  File  must  be 

created  by  ALOC  and  not  read  in 

o  SETTING  User  specifies  values  for  ALOC  parameters  other 

than  their  default  values 


SMAT 


User  specifies  values  for  the  SMAT  array 


The  ALOC  module  will  execute  properly  in  the  absence  of  any  of  these 
adverbs . 


3.2.1  The  FLAGRBST  Clause.  This  clause  specifies  interaction  between 
weapon  groups  and  the  target  attribute  FLAG  which  may  have  a  value  of 
0-9  Inclusive.  (A  value  of  0  indicates  that  no  weapon  is  restricted 
from  that  target  because  of  its  flag.)  In  this  clause,  the  user  speci¬ 
fies  which  groups  are  restricted  and  what  target  FLAG  values  they  may  or 
may  not  attack.  The  general  form  of  the  FLAGREST  clause  is 


FLAGREST 


firoup 

flag 


[  .  group 
[a. 


I  INCLUDE  } 
I  EXCLUDE  | 


The  adverb  may  be  followed  by  any  number  of  sets  of  inputs  each  consist¬ 
ing  of  three  parts.  First  a  set  of  one  or  more  group  numbers  separated 
by  commas  are  supplied  followed  by  either  of  the  two  special  words: 
INCLUDE  or  EXCLUDE.  Third  a  set  of  one  or  more  flag  numbers  separated 
by  commas  define  entries  for  attribute  FLAG. 


The  relationship  of  the  group  numbers  to  the  flag  numbers  is  specified 
by  the  intervening  special  word.  If  the  word  is  INCLUDE,  then  the  spec¬ 
ified  groups  are  restricted  from  all  but  the  specified  flags.  If  the 
word  is  EXCLUDE,  then  the  specified  groups  are  restricted  from  the  spec¬ 
ified  flags.  For  example 

FLAGREST  1,2,3  INCLUDE  3,4  5,6  EXCLUDE  7,8 


The  result  of  this  example  would  be  that  groups  1,  2,  and  3  could  not 
attack  targets  where  FLAG  values  were  1,  2,  5,  6,  7,  8,  or  9  and  groups 
5  and  6  could  not  attack  targets  where  FLAG  values  were  7  or  8. 


3.2.2  The  LOCREST  Clause.  This  clause  specifies  interaction  between 
weapon  groups  and  the  country  location  code  of  targets.  In  this  clause, 
the  user  specifies  which  groups  are  restricted  and  what  target  country 
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locations  they  may  or  may  not  attack.  The  general  form  of  the  LOCREST 
clause  is: 

LOCMSX  {jUffj 

country  location  ^  .  country  location  .  ...  ,-A  country  location j 

The  adverb  may  be  followed  by  any  number  of  sets  of  inputs,  each  consist¬ 
ing  of  three  parts.  First  a  set  of  one  or  more  group  numbers  separated 
by  commas  are  supplied  followed  by  either  of  the  two  special  words: 
INCLUDE  or  EXCLUDE.  Third  a  set  of  one  or  more  country  location  codes 
(i.e.,  US,  UR,  etc.)  separated  by  commas  are  entered. 

The  relationship  of  the  groups  to  the  country  codes  is  specified  by  the 
intervening  special  word.  If  the  word  is  INCLUDE,  then  the  specified 
groups  may  not  attack  any  targets  but  those  with  the  specified  country 
locations.  If  the  word  is  EXCLUDE,  the  specified  groups  may  attack  only 
targets  whose  country  locations  are  other  than  those  given. 

An  example  of  a  LOCREST  clause: 

LOCREST  1,2,3  INCLUDE  UR,CH  4, 5, 6, 7  EXCLUDE  PO,CZ,BU 

The  result  of  this  example  would  be  that  groups  1,  2,  and  3  could  only 
attack  targets  whose  country  location  codes  were  "UR"  or  "CH",  and 
groups  4,  5,  6,  and  7  could  not  attack  targets  whose  country  codes  were 
"PO",  "CZ"  or  "BU". 

3.2.3  The  MINRANGE  Clause.  This  clause  allows  the  user  to  specify  a 
value  for  the  RNGMIN  attribute  other  than  that  given  for  a  group.  The 
clause  consists  of  a  new  minimum  range  value  followed  by  one  or  more 
group  numbers.  Parantheses  are  optional.  The  general  form  is: 

MINRANGE  (minimum  range  A  group  group  .  .  .  A  group j  ) 

As  many  sets  of  values  may  appear  in  a  single  clause  as  desired.  The 
user  should  note  that  use  of  this  clause  alters  the  value  of  the  RNGMIN 
attribute  for  this  run  of  ALOC  only  and  does  not  alter  its  data  base 
value  in  any  way.  An  example  of  a  MINRANGE  clause  is: 

MINRANGE  (1000,1,2,3,4)  (1500,9,10) 

The  result  would  be  to  set  the  RNGMIN  value  to  1000  for  groups  1,  2,  3 
and  4  and  to  1500  for  groups  9  and  10. 

3.2.4  The  MIRVREST  Clause.  This  clause  allows  the  user  to  specify  re¬ 
strictions  for  MIRV  weapon  types.  These  types  may  be  restricted  to 
particular  target  classes.  In  addition  to  standard  classes,  they  may 
be  restricted  to  complexes  (C0MPLE),  defended  complexes  (COMPLD) ,  and/or 
defended  targets  (DEFEND). 
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The  general  form  of  the  MIRVREST  clause  is: 

MIRVREST  (payload  name  M  class  ^  A  class  .  .  .  A  class j  ) 

The  adverb  is  followed  by  any  number  of  sets  of  values  separated  by 
commas.  The  first  value  is  the  name  of  a  MIRV  group's  payload  table. 

The  remaining  values  are  class  names  of  those  targets  which  the  indi¬ 
cated  group(s)  may  attack.  The  parentheses  are  optional.  An  example 
follows . 

MIRVREST  (  MM-III  ,  COMPLE ,COMPLD,  U/I  )  (  POSEID  .BOMBER) 

This  effect  of  this  would  be  to  restrict  weapons  with  the  payload  table 
name  "MM-III"  to  complexes  (defended  or  not)  and  target  class  "U/I". 
Further  weapons  with  the  payload  table  name  "POSEID"  would  only  be  able 
to  attack  single  targets  of  class  "BOMBER".  Note:  Although  this  option 
was  designed  for  MIRV  weapons,  there  is  no  current  restriction  which 
would  prevent  use  of  this  option  for  non-MIRV  weapon  systems. 

3.2.5  The  MODRANGE  Clause.  This  clause  allows  the  user  to  decrease  the 
data  base  attributes  RANGE  and  RANGEREF  for  allocation  purposes.  The 
values  of  RANGE  and  RANGEREF  initially  stored  within  the  data  base  are 
not  altered.  Module  ALOC  conducts  the  allocation  with  the  user  directed 
multipliers  values  but  this  information  is  not  passed  to  other  QUICK 
processors. 

The  user  supplies  multipliers  for  RANGE  and  RANGEREF  on  a  weapon  group 
basis.  The  general  form  Is: 

MODRANGE  (range  multiplier  £_/  refuel  range  multiplier j 
*  group  group  .  .  .  A  group  j  ) 

The  clause  consists  of  any  number  of  sets  of  values.  The  first  value  of 
the  set  is  a  multiplier  for  the  RANGE  attribute  which  is  followed  by  the 
optional  slash  (/)  and  a  multiplier  for  the  RANGEREF  attribute.  Follow¬ 
ing  the  multipliers  are  the  group  numbers  to  which  the  multipliers  are 
applicable.  Each  group  number  must  be  preceded  by  a  comma.  Numeric 
sets  of  multipliers  may  be  defined  by  leaving  at  least  one  space  between 
each  data  set. 

If  the  multiplier  for  RANGEREF  is  omitted  it  is  treated  as  the  same  as 
that  for  RANGE. 

An  example  of  a  MODRANGE  clause  would  be: 

MODRANGE  (.8/. 9, 1,2, 3)  (.7,4,5) 

The  effect  would  be  to  multiply  the  RANGE  attribute  by  .8  and  the 
RANGEREF  attribute  by  .9  for  groups  1,2  and  3.  Also,  both  the  RANGE 
and  RANGEREF  attributes  of  groups  4  and  5  would  be  multiplied  by  .7. 
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3.2.6  The  ONPRINTS  Clause.  This  clause  allows  the  user  to  control  the 
appearance  of  various  print  options.  The  options  available  are  detailed 
in  table  2.  Each  option  may  be  selected  and  the  frequency  of  its  appear¬ 
ance  (s)  controlled  as  to  the  pass  and/or  targets.  The  control  parameters 
available  and  their  default  settings  are: 

First  pass  of  appearance  -  default  pass  1. 

Last  pass  of  appearance  -  default  pass  9999 

First  target  of  appearance-  default  target  1 

Last  target  of  appearance  -  default  target  9999 

Frequency  of  appearance  as  to  target  -  default  every  target  (1) 

In  addition,  options  1,  2,  4  and  16  are  initially  selected  with  the  fre¬ 
quency  of  option  4  set  at  50.  The  user  may  request  that  these  options 
not  appear.  The  general  form  of  the  ONPRINTS  clause  is: 


ONPRINTS 


option  £  A  first  target  2  last  target  j_  frequency j 
first  pass  2  last  passj  jjs 


NOT 


option^ 


This  clause  has  a  number  of  optional  forms.  Following  the  adverb  the 
user  may  input  any  number  of  sets  of  values  in  various  forms.  A  single 
number  (in  the  range  1-30,  see  table  2)  will  cause  that  option  to 
appear  with  default  controls.  If  the  user  wishes  to  suppress  a  default 
option  (i.e.,  1,  2,  4,  or  16)  the  option  number  is  preceded  by  the  NOT 
operator. 

User  alterations  to  target  control  defaults  are  preceded  by  a  comma.  A 
number  following  the  comma  will  be  used  as  a  first  target  control.  A 
number  preceded  by  a  hyphen  will  be  used  as  a  last  target  and  a  number 
preceded  by  a  slash  will  be  used  as  a  frequency.  Only  those  controls 
which  the  user  wishes  to  charge  need  be  included.  Similarly,  the  pass 
controls  are  preceded  by  an  asterisk. 

For  example: 

ONPRINTS  NOT  4  5,50*-2  6,/4 

Would  cause  option  4  to  be  surpressed,  option  5  to  appear  beginning 
with  target  50  and  for  passes  one  and  two,  and  option  6  to  have  a  fre¬ 
quency  of  4. 


3.2.7  The  PUNCH  Clause.  This  adverb  allows  the  user  to  request  that 
the  final  Lagrange  multiplier  be  saved  on  an  output  unit.  The  format 
used  for  this  output  is  such  that  it  can  be  assessed  on  later  runs  by 
the  READMUL  clause.  The  general  form  of  the  PUNCH  clause  is 


PUNCH 


^ NEW  *  unit  number j 


The  optional  portion  is  used  to  specify  an  output  unit  other  than  43 
(system  punch). 
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OPTION 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 


Table  2.  Description  of  Print  Option  Numbers 
for  Program  ALOC  (Part  1  of  2) 


DESCRIPTION  OF  PRINT 
Input  weapon  data 

Main  summary  prints  after  weapons  have  been  allocated  to 
target 

Not  used 

Print  for  all  weapon  groups  the  Lagrange  multipliers,  the 
total  number  of  weapons  allocated  (RNALL) ,  and  number  of 
weapons  allocated  this  pass  (NALL)  with  total  weapon  value 
and  value  of  error  in  allocation 

Print  of  data  on  target  weights  and  rates  of  change  of 
weights 

Target  input  data  before  allocation  begins 

Basic  weapon/target  interaction  data  before  allocation  of 
weapons  to  target 

Risk  array  before  allocation  begins  on  target 

Summary  of  weapons  assigned  to  present  target  and  marginal 
values  for  each  (see  option  22  for  companion  print  of  po¬ 
tential  weapons) 

Input  data  to  the  single  target  allocator  (STALL)  --  i.e., 
output  from  WAD 

Initial  values  for  lambdas,  VALWFNS  and  VALERR,  at  start 
of  module  only 

Debugging  print  showing  synopsis  of  calculation  of  actual 
payoff  by  WAD 

Debugging  print  showing  after-the-fact  synopsis  of  poten¬ 
tial  weapon  added  and  weapon  deleted  payoff  calculations 
by  WAD 

Not  used 

Not  used 
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Table  2.  (Part  2  of  2) 


OPTION 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 


DESCRIPTION  OF  PRINT 


Defense  level  and  attack  mode  print  for  targets  with  ter¬ 
minal  ballistic  missile  defense 

Not  used 

Not  used 

Planning  factor  summary  for  targets  with  terminal  ballis¬ 
tic  missile  defenses 

Summary  of  WADOUT  cost  payoff  benefit,  etc. 

Complete  listing  of  allocation  error  estimates  (ALUEREST) 

Summary  of  marginal  payoff  data  for  potential  weapons  fol¬ 
lowed  by  resulting  STALL  decision:  a  companion  print  to 
print  number  9 

Printout  of  timing  information 
Memory  dump  and  run  termination 

List  of  inactive  switches  for  each  weapon  group  as  related 
to  current  target 

Print  of  preferred  corridors  and  computed  penetration  prob¬ 
abilities  for  each  penetration  corridor  for  all  bomber 
groups  relative  to  current  target;  available  only  on  first 
pass 

Best  rate  of  return  for  missile  allocation  in  DEFALOC 

Debugging  print  of  allocations  and  payoff  computed  in 
RESVAL 

Print  of  Lagrange  multiplier,  balance  parameter,  and  stock¬ 
pile  for  salvoed  missiles 

Print  of  bomber  payload  indicators  and  allocation  fractions 
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Figure  20.  Defended  Target  Summary  Print 
(Print  Option  16) 
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Figure  21.  (Part  2  of  2) 


The  quantity  SDELTEFF  therefore  provides  an  estimate  of  how  efficient 
the  allocation  would  have  been  if  the  allocation  had  been  terminated 
one  pass  earlier.  Presumably,  the  current  efficiency  is  substantially 
higher,  but  SDELTEFF  does  not,  at  this  point,  give  any  indication  of 
how  much.  It  is  nevertheless  of  value  in  developing  experience  on  how 
soon  the  PROGRESS  .75  phase  can  be  terminated.  When  PROGRESS  is  equal 
to  1.00  the  multipliers  are  frozen,  and  this  role  of  SDELTEFF  ceases  to 
be  relevant.  The  quantity  is  then  reset  to  zero.  Thereafter  it  pro¬ 
vides  a  measure  of  the  effect  on  the  profit  of  closing  to  the  exact 
stockpile.  Usually  during  the  closing  phase  SDELTEFF  goes  slightly  nega¬ 
tive.  However,  since  during  this  phase  we  continue  to  replace  alloca¬ 
tions  originally  produced  with  slightly  different  values  of  the  multi¬ 
pliers,  the  value  may  go  positive  for  a  while  until  the  closing  forces 
get  large  enough  to  force  closure  even  at  some  loss  of  profit.  Thus  the 
value  of  SDELTEFF  at  the  end  of  the  PROGRESS  *  1.0  phase  measures  the 
loss  of  profit  associated  with  closing.  In  the  event  that  closing  re¬ 
quires  more  than  one  full  pass  a  test  has  been  inserted  which  causes 
SDELTEFF  to  continue  to  accumulate  over  more  than  one  pass  when  PROGRESS 
-  1.0. 


Finally,  when  PROGRESS  *  2.0  the  quantity  is  again  set  equal  to  zero. 

If  a  verification  pass  is  carried  out,  SDELTEFF  then  measures  any  in¬ 
crease  in  profit  in  the  verification  pass  relative  to  the  final  alloca¬ 
tion.  In  this  role  it  defines  an  upper  limit  on  the  inefficiency  of 
the  actual  allocation. 

3. 3.1. 2.2  Summary  Weapon  Allocation  Data.  This  print  (print  option  4) 
displays  a  summary  of  the  weapon  allocation.  It  always  appears  at  the 
end  of  the  weapon  allocation  process.  If  a  verification  pass  is  made, 
this  print  appears  at  the  end  of  that  pass.  Figure  22  displays  this 
print . 

3. 3. 1.2. 3  Timing  Information  for  ALLOCATE  Function.  This  print  (option 
23)  displays  the  amount  of  time  spent  in  processing  the  various  phases 
of  weapon  allocation. 

3. 3. 1.2. 4  Termination  of  ALLOCATE  Function.  The  ALLOCATE  function  will 
terminate  normally  on  one  of  three  conditions: 

a.  More  than  1.5  passes  while  PROGRESS  *  1.0 

b.  |VALERR|  < VALWPNS  *  ERRCL0S,  where  VALERR  is  the  absolute  value 
of  the  sum  of  the  Lagrange  multipliers  for  all  under-  or  over¬ 
allocated  weapons,  VALWPNS  is  the  sum  of  the  Lagrange  multipliers 
for  all  weapons  in  the  stockpile,  and  ERRCLOS  is  a  user-input 
parameter  for  the  ALLOCATE  function. 

c.  SUMSQERR  < 1/ (10*NTGTS^)  where  NTGTS  equals  the  number  of  tar¬ 
gets  and  SUMSQERR  equals  the  sum  of  the  squares  of  the  alloca¬ 
tion  error  estimates. 
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Figure  22.  Weapon  Allocation  Summary  Print  (Print  Option  4) 


d.  If  convergence  is  unlikely,  i.e.,  PROGRESS  *  0.75  is  not 
achieved  by  the  end  of  PASS  3,  the  run  will  be  terminated 
(see  Error  Messages,  ALLOCATE  Function,  message  13). 

When  condition  1-3  occurs,  the  message  "FINAL  WEAPON  ALLOCATION"*  is 
printed  followed  by  a  print  of  options  2,  4,  and  23.  If  the  input  param¬ 
eter  IVERIFY  is  nonzero,  a  verification  pass  is  then  made.  At  the  end  of 
the  verification  pass,  or  immediately  following  prints  described  above, 
the  message  "END  OF  WEAPON-TARGET  PROCESSING"  is  printed,  followed  by  a 
print  of  options  2,  4,  and  23. 

3. 3.1. 3  Detailed  Prints.  These  prints  are  described  according  to  their 
print  option  as  follows. 

a.  Print  Option  1  (Basic  Weapon  Group  Information).  This  print  is 
a  standard  print  described  in  figure  19. 

b.  Print  Option  2  (Weapon  Allocation).  This  print  is  a  standard 
print  described  in  figure  21. 

c.  Print  Option  4  (Weapon  Allocation  Summary) .  This  print  is  a 
standard  print  described  in  figure  22. 

d.  Print  Option  5  (Target  Weight  Information) .  This  is  a  print  of 
data  on  target  weights  and  rates  of  change  of  weights.  Figure 
23  displays  this  print. 

e.  Print  Option  6  (Basic  Target  Data).  This  print  displays  the 
basic  target  data  prior  to  the  allocation  of  weapons  to  the 
target.  Figure  24  displays  this  print. 

f.  Print  Option  7  (Weapon/Target  Interaction  Data).  This  print  dis¬ 
plays  the  basic  weapon/target  interaction  data  before  weapon 
allocation.  Figure  25  displays  this  print. 

g.  Print  Options  8,  9,  10.  These  prints  are  debug  prints  described 
in  the  next  section. 

h.  Print  Option  11  (Initial  Values  of  Lagrange  Multipliers).  This 
print,  available  only  at  the  start  of  the  ALLOCATE  function, 
prints  the  initial  values  of  the  local  Lagrange  multipliers. 
Figure  26  displays  this  print. 

i.  Print  Options  12  and  13.  These  prints  are  debug  prints  de¬ 
scribed  in  the  next  section. 

j .  Print  Option  16  (Defended  Target  Summary) .  This  print  is  a 
standard  print  described  in  figure  20. 


For  condition  4,  the  referenced  error  message  is  printed. 
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PRINT  NO 


5 


WTMC  <§L 
WTRM6  (IL 

wtsum  © 


0  1 
7.28011*000 
l ,oonoo*ooo 
2.00786*002 


0  2 
7,28011*000 
1,00000*000 
2.00786*002 


0  3 

7,28011*000 

1,00000*000 

2,01287*002 


HEADING  LABEL 


DESCRIPTION 


0  1 


Column  for  first  (shortest)  integration 
period 


0  2 


Column  for  second  integration  period 


0  3 


Column  for  third  (longest)  integration 
period 


0  WTFAC 


Current  running  target  weight  in  each 
integration  period 


0  WTRATE 


Rate  of  increase  of  target  weights  in 
each  integration  period 


0  WTSUM 


Sum  of  target  weights  in  each  integration 
period 


Figure  23.  Print  Option  5  -  Target 
Weight  Information 
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PRINT  NO 

© 

tgtno 

72 

© 

INCLASS 

/-s  0/1 

© 

tval  1.03 

TAU©  1000.33 

.  6  TARGET  NO.  72 

©  © 
TCTNAPE  T6U.AT 

ONE  PRO  A  8. 40 

RCITT-  7 

1.03  1.00 

1000.03  1003.00 

PASS  1 

©  ©  © 

TGUONG  T6TRA0  NR 

525.80  2.80  1 

©  ©  ©  © 

NlToET  P I  NIC  I  .  L  PA  X  K  ILL  PAxCOST 

0  0.  1.03  10.03 

1.00  1.00 

1000.00  1000.00 

HEADING 

LAIEL 

DESCRIPTION 

© 

TGTNO 

Tartat  number  (asslgnad  by  PLAN SET) 

© 

TGTHAME 

Target  naaa 

© 

TCTLAT 

Targat  latltuda 

© 

TGTLONG 

Targac  longitude 

© 

TGTRAD 

Targat  radius  (nautical  alias) 

© 

IOC 

Nuabar  of  tlaa  valua  coaponanta 

© 

IE  CLASS 

Targat  class  naaa 

© 

1H1IPE 

Targat  typs  naaa 

© 

TABDEF 

Laval  of  tsralnal  boabar  dafanse 

© 

NISSEF 

Nuabar  of  tsralnal  ballistic  alsslls  Intsreaptors 

© 

him  l  LL 

Minimum  required  kill  probability 

© 

MAXXXLL 

Mariana  desired  kill  probability 

© 

MAX COST 

Marl nun  ratio  of  weapon  cost  to  targat  valua 
accaptabla  to  achieve  MINKILL 

© 

FVAL 

Fraction  of  valua  regaining  In  aach  tlaa  period 

© 

TAD 

Terminating  tlaa  of  aach  tlaa  component 

Figure  24.  Print  Option  6 — Basic  Target  Data 
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ACT  Value  of  inactive  flag 

MRG  PAYOFF  Marginal  payoff  for  this  weapon 

MRG  COST  Value  of  Lagrange  multiplier  for  this  weapon 

MRG  PROFIT  Marginal  profit  I(f4)  -  (fsl  l 
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Figure  31.  (Part  2  of  2) 
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Figure  32.  Print  Option  10 — Weapon  Profit  and  Efficiency  Information 


11  UNSATISFACTORY  PROGRESS.  RUN  TERMINATED 

After  three  full  passes  through  the  target  list  the  value  of 
PROGRESS  is  less  than  0.75.  The  probability  that  the  alloca¬ 
tion  process  will  converge  to  the  correct  stockpile  at  this 
point  is  very  low.  The  job  is  therefore  terminated.  There 
are  a  large  number  of  conditions  which  can  cause  this  problem. 
A  close  check  on  the  values  of  the  target  and  planning  factors 
should  be  made  to  see  if  the  desired  values  are  being  used. 

If  a  run  of  this  function  with  all  default  user  input  param¬ 
eters  does  not  remove  this  problem,  consult  a  maintenance  pro¬ 
grammer. 

12  FIXED  ASSIGNMENT  REQUEST  NOT  HONORED  FOR  GROJJP  (?)  ON  TARGET 
DESIG  -  (l)  -  INDEXNO  -  (?)  -  TARGET  NO.  -  (T) 

TARGET  NOT  -  J (£)  W 

PROBLEM  IS  (?) 

The  user  has  requested  a  fixed  assignment  ofa  weapon  from 
group  to  a  target  with  designator  code  (2)  ,  index  num¬ 
ber  Q?  ,  and  target  number  (?)  .  The  request  cannot  be  hon¬ 
ored  and  the  weapon  is  not  allocated  at  all  (to  any  target). 
The  reason  for  not  honoring  the  request  is  given  in  .  The 
reasons  are  as  follows: 
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e 

CNTRYL 

• 

FLAG 

e 

MINRAN 

• 

MIRV 

• 

NAVAL 

t 

• 

PENETR 

• 

RANGE 

• 

VALUE 

—  Restriction  by  country  code  (LOCREST  option) 

—  Restriction  by  flag  code  (FLAGREST  option) 

—  Restriction  by  minimum  range  (MINRANGE  option) 

—  Restriction  of  MIRV  weapons  (MIRVREST  option) 

—  Restriction  of  weapons  with  PKNAV  ■  0  to  tar¬ 
gets  to  class  NAVAL  and  vice  versa 

—  Inadequate  capability  to  penetrate  to  the 
target;  if  this  message  occurs  for  a  missile, 
check  attributes  RADPX  and  PKTK. 

—  Inadequate  range  to  reach  the  target  (possi¬ 
bly  RANGEMOD  option) 

0  —  The  target  has  zero  value  at  the  weapon  time 
of  arrival.  (Data  base  entry  or  possibly 
VALUEMOD  option  of  module  PREPALOC.) 


LOOP  -  (T) 


In  this  message  (?)  is  the  total  number  of  targets  encountered 
so  far  on  which  more  than  100  weapon  addition  or  deletion 
operations  (IOP)  were  required  before  subroutine  STALL  termin¬ 
ated  the  allocation  process.  Once  this  condition  occurs,  this 
message  is  printed  as  every  succeeding  target  is  processed. 

On  each  target  with  more  ttjan  100  weapon  addition  or  deletion 
operations,  the  value  of  is  incremented  by  one.  This 
message  is  for  information  only;  no  user  action  is  required. 


Figure  45.  (Part  2  of  3) 
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14  TARGET  MINKILL  REQUIRES  TOO  MANY  WEAPONS 

On  target  with  target  number  ©  ,  a  target  with  terminal  ba* -  | 
listic  missile  defenses,  the  required  minimum  target  destruc-  | 
tion  probability  cannot  be  achieved  after  an  allocation  of  40'.  I 
of  the  total  missile  force  that  can  reach  this  target.  The  I 

program  continues  using  the  allocation  of  40%  of  each  missile  I 
group  that  can  be  allocated  to  tt  is  target.  This  message  1 c 
for  information  only;  no  user  action  is  required.  j 

15  BOMBER  FROM  GROUP  (T)  CANNOT  BE  FIXED  IN  A  MISSILE  SATUFaTION 
ATTACK  ON  TARGET  (2)  -  INDEX  -  Q)  TARGET  (£) 

The  user  has  fixed  a  bomber  weapon  from  group  on  a  target 
where  he  has  fixed  more  than  30  weapons.  The  only  ca;^  where 
an  excess  of  30  weapons  is  allowed  is  a  missile  saturation  1 
attack  on  a  target  with  terminal  ballistic  missile  defenses. 

The  fix  request  for  this  bomber  •;*apon  is  ignored  and  process¬ 
ing  proceeds.  The  target  name  is  disol  lyed  as  ;  the  index 
umber  as  ;  the  target  a u^Lcr  as  (V)  .  I 


Figure  45.  (Part  3  of  3) 
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Figure  52.  (Part  2  of  2) 
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1  (13)  IS  AN  ILLEGAL  ADVERB  NUMBER  FOR  EVALUATE  —  IT  WAS  THE 
(13) (A2)  ADVERB 

The  indicated  adverb  is  not  legal. 

2  (15)  IS  NOT  THE  VERB  FOR  EVALUATE  ~  CHECK  COP 
Module  EVALALOC  executed  with  the  incorrect  verb. 

3  UNEXPECTED  FUNCTION  CODE  OF  (A6)  FOR  (A6)  FUNCTION  ASSUMED  TO 
BE  (A6) 

An  unknown  function  code  was  encountered.  Check  data  base 
entries. 

4  ONPRINTS  NOT  FOLLOWED  BY  A  NUMBER  —  NO  SAMPLE  TARGETS  WILL 
BE  PRINTED 

The  print  adverb  does  not  specify  how  many  targets  are  to  be 
printed. 

5  SETTING  CLAUSE  CONTAINS  A  NON-ATTRIBUTE  (15)  (8013) 

Check  spelling  in  SETTING  clause. 

6  ATTRIBUTE  NOT  BEING  SET  TO  A  CONSTANT 

The  SETTING  clause  is  restricted  to  setting  the  value  of  an 
attribute  to  a  specific  value. 

7  END  OF  PHRASE  BUT  CANNOT  FIND  MARKER  OR  CONNECTOR 
Check  text  English  syntax. 

8  COUNTRIES  NOT  FOLLOWED  BY  INCLUDE  EXCLUDE  (012)  (15)  ASSUMING 
INCLUDE 

Check  for  spelling  of  include/exclude. 

9  COUNTRY  CODE  NOT  FOLLOWED  BY  COMMA  OR  END  OF  CLAUSE  (  (2013) 
(15)) 

Country  codes  must  be  separated  by  a  comma.  Check  for  a 
country  code  which  is  a  COP  special  word  or  null. 

10  TARGET  TYPE  NOT  FOUND  IN  TGTMODIF 

Check  target  type  spelling  in  TGTMODIF  clause. 


Figure  53.  EVALALOC  Error  Messages  (Part  1  of  3) 
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SECTION  5.  MODULE  ALOCOUT 


5.1  General  Purpose 

Module  ALOCOUT  selects  optimal  aim  point  offsets  for  weapons  allocated 
to  complex  targets  and  reorders  the  weapon  group  assignment  chains  for 
use  within  the  Sortie  Generation  subsystems.  For  missile  groups,  the 
sort  in  according  to  salvo  number  and  within  salvo,  according  to  attri¬ 
bute  RVAL.  For  bomber  groups  the  new  order  is  a  collection  of  strikes 
belonging  to  the  penetration  corridor  that  has  the  largest  number  of 
assignments  followed  by  strikes  of  the  penetration  corridor  that  has 
the  next  largest  number  of  assignments  and  so  on.  Within  each  collec¬ 
tion  of  strikes  belonging  to  the  same  penetration  corridor,  the  assign¬ 
ments  are  further  sorted  based  on  attribute  RVAL.  The  user  should  note 
that  if  attribute  ATTPOS  ^  0,  only  those  weapon  groups  where  ATTINC  ■ 
ATTPOS  are  reordered. 


5.2  Input 


The  only  options  available  to  the  user  in  module  ALOCOUT  are  to  specify 
the  type  and  frequency  of  the  various  prints  and/or  to  specify  the  maxi¬ 
mum  number  of  iterations  to  be  executed  by  the  generalized  function  mini¬ 
mizes  which  is  used  to  select  the  aim  point  offsets  for  those  weapons 
assigned  to  complex  targets.  The  general  command  is: 


DG2SELECT 


ONPRINTS  option  option 
FINDMIN  imax] 


5.2.1  The  ONPRINTS  Adverb.  This  adverb  selects  various  print  or  calcu¬ 
lation  options.  It  recognizes  any  series  of  numbers  (each  number  separ¬ 
ated  by  at  least  one  blank)  with  values  varying  from  one  to  nine.  The 
presence  of  any  of  the  numbers  within  the  clause  selects  the  correspond¬ 
ing  option  which  are: 

o  1  —  Selects  the  detailed  target  print.  For  this  option  only 

a  print  frequency  may  be  selected.  This  is  entered  by 

placing  a  slash  (/)  after  the  number  one  followed  by  the 
numeric  value  of  the  desired  print  frequency.  An  entry  of 
1/10  will  print  every  ten  targets.  The  default  entry  (1 
by  itself)  prints  all  targets 

o  2  —  Selects  the  bomber  weapon  group  summary  print 

o  3  —  Selects  the  missile  weapon  group  sutmnary  print 

o  4  —  If  entered  offsets  are  not  calculated 

o  5  —  Selects  the  target  data  input  to  subroutine  DGZSEL  print 

o  6  —  Selects  the  DGZSEL  computational  value  print 
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•  7  —  Selects  the  DGZSEL  improvement  print 

e  8  —  Selects  maintenance  prints 

•  9  —  Selects  timing  information  print 

5.2.2  The  FINDMIN  Adverb.  If  absent  the  FINDMIN  subroutine  is  not 
used.  If  present  the  FINDMIN  subroutine  is  used  and  parameter  'imax* 
is  set  to  the  maximum  number  of  iterations. 

5.3  Output 

5.3.1  Standard  Output.  All  output  is  optional  and  must  be  selected  by 
the  user. 

5.3.2  Nonstandard  Output .  Figures  57  to  60  presents  the  output  for 
print  options  available  to  the  user  within  the  ONPRINTS  clause. 

5.3.3  ALOCOUT  Error  Messages.  The  error  messages  for  ALOCOUT  are  shown 
in  figure  61. 
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Figure  54.  Print  Option  1:  Detailed  Target  Print  (Part  1  of  3) 


DESCRIPTION 


Weapon  penetration  probability 


A1.T02;  DETAILED  BOMBER  SUtttARY 


Figure  55.  Print  Option  2:  Detailed  Bomber  Summary 


Optl'»'  2:  Detailed  Missile  Summary 


TGT  DATA  INPUT  To  OGZSEl 
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Figure  57.  Print  Option  5:  Target  Data  Input  to  DGZSEL  Debug  Print 
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Figure  58.  Print  Option  6:  DGZSEL  Computation  Values  Debug  Print 


Figure  59.  Print  Option  7:  DGZ  Improvement  Print 


1  MODULE  ALOCOUT  CANNOT  DETERMINE  ADVERB  (012) 
Check  for  correct  spelling  within  the  command. 

2  ERROR  IN  ONPRINTS  CLAUSE 

Check  for  proper  syntax  within  ONPRINTS  clause. 

3  ***  ERROR — NFIX  = 


NFIX,  the  number  of  weapons  allocated  through  the  fixed 
assignment  capability,  is  negative;  the  run  is  aborted. 

4  AAA  AAA 

ABANDON  DGZSEL- ON  COMPLEX  TARGET  NAME  INDEX  COMPONENT 
TGTNAME  INDEXNO 

AAA  AAA 


Subroutine  COMPRESS  has  been  entered  with  open  tolerances 
more  than  50  times  in  succession  so  no  further  attempt  to 
use  DGZSEL  is  made  for  this  target. 

5  ***  TOLERANCES  OPENED  N  TIMES  IN  SUBROUTINE  COMPRESS  TO 
REDUCE  NUMBER  OF  TARGET  POINTS  TO  250.  TARGET  NAME  INDEX 
NUMBER  INDEX 

COMPRESS  opened  tolerances  N  times  to  reduce  number  of  tar¬ 
get  elements.  NAME  is  the  target  name.  INDEX  is  the  target 
index  number.  This  is  a  message  produced  by  subroutine 
COMPRESS,  but  is  not  an  error  message. 

6  ALOCOV T  PROCESSING  COMPLETED  ON  IW  WEAPONS  IT  TARGETS 

Statement  of  number  of  weapons  and  targets  processed  by 
ALOCOUT,  where  number  of  targets  is  the  sum  of  the  numbers 
of  simple  and  complex  targets  and  multiple  target  elements, 
which  were  assigned  weapons. 

7  BAD  CALL  ON  ERGOT 

More  than  10  serires  are  being  run  in  parallel;  control  is 
returned  to  the  calling  subprogram  without  computing  ERGOT1. 


Figure  61.  ALOCOUT  Error  Messages 
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DISTRIBUTION 


Addressee  Copies 


CCTC  Codes 

C124  (Reference  and  Record  Set) .  3 

C124  (Stock) .  6 

Cl  26  .  2 

C3 1 3  .  1 

C314  7 

C630  1 

DCA  Code 

205  1 

EXTERNAL 

Chief,  Studies,  Analysis  and  Gaming  Agency,  OJCS 
ATTN:  SFD,  Room  1D935,  Pentagon,  Washington,  DC 
20301  .  2 

Chief  of  Naval  Operations,  ATTN:  0P-654C,  Room  BE781 
Pentagon,  Washington,  DC  20350  2 

Commander-in-Chief,  North  American  Air  Defense  Command 
ATTN:  NPXYA,  Ent  Air  Force  Base,  CO  80912  2 

U.S.  Air  Force  Weapons  Laboratory  (AFSC) 

ATTN:  AFWL/SUL  (Technical  Library), 

Kirtland  Air  Force  Base,  NM  87117  .  1 

Director,  Strategic  Target  Planning,  ATTN:  (JPS),  Offutt 
Air  Force  Base,  NE  68113  2 

Defense  Technical  Information  Center,  Cameron  Station, 

Alexandria,  VA  22314  72 
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